home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / libs / Tran43pch.readme < prev    next >
Text File  |  1997-09-05  |  8KB  |  178 lines
  1. Short:        Patches Translator42.4, 43.0  to Translator43.1
  2. Author:       mbarlow@pacific.telebyte.net
  3. Uploader:     mbarlow@pacific.telebyte.net
  4. Version:      43.1
  5. Type:         util/libs
  6. Requires:     Translator version 42.4 or 43.0 installed; Installer
  7. Replaces:     Tran43pch.lha 43.0
  8. Distribution: Unlimited
  9.  
  10.     This version of the Translator Library was developed from the source
  11. code posted to the Aminet by Francesco Devitt.  As such it remains largely
  12. his work.  Version 43.0 added new accent file rules to facilitate number
  13. expression and fixes three problems I have encountered with the original
  14. Translator42.  Version 43.1 adds the placement of the Narrator escape code
  15. sequence after the end of the translated text output string to achieve
  16. compatibility with those programs that give the whole translation buffer to
  17. the Narrator.
  18.  
  19.   The basic Translator43 changes from version 42.4 are as follows:
  20.  
  21.  
  22. 1.  Added Empty Match Feature.
  23.  
  24.   Extra text may be inserted into the output string based on the text
  25. pattern defined by the prefix and suffix rules alone.  This facilitates
  26. the process of expanding numbers as text.
  27.  
  28. 2.  Added Suffix Text Induction Feature.
  29.  
  30.   Some or all of the matching suffix pattern text characters may be pulled
  31. into a bracket delimited text-replacement string.  This text may be pulled in
  32. ahead or behind the replacement text.  This facilitates number expansion
  33. and enables re-sequencing of text ("$51" to "fifty one dollars" or "51" to
  34. "ein und fünfzig")
  35.  
  36. 3.  Added Zero or One Match Condition.
  37.  
  38.     This allows the specification of optional prefixes or suffixes that
  39. only occur once.
  40.  
  41. 4.  Fixed Word Separator Problem.
  42.  
  43.     Translator42 does not recognize the same set of word separators as the
  44. original Translator37.  This causes unusual pronunciation, in some cases,
  45. when punctuation marks or numbers are combined with text.  By default,
  46. Translator 43 recognizes only the standard Latin alphabet and the
  47. ISO-8859-1 international characters as members of the alphabet.  All
  48. characters not in this "alphabet set" are treated as word-separators.
  49.  
  50. 5.  Fixed Buffer Overrun Problem.
  51.  
  52.     Translator42 may crash your system if the buffer that is provided by the
  53. program using this library is not large enough to handle the resulting
  54. text. Translator42 can fail to notice the end of the buffer and continue on
  55. writing into unauthorized memory space.  This problem is now fixed.
  56.  
  57. 6.  Reduced The False Text Command Problem.
  58.  
  59.     Translator42 allows accent and scope changes to be made by in-line text
  60. commands delimited by simple braces and backslashes.  This can be a problem
  61. when reading general text (EMAIL or BBS) that may contain these characters
  62. or ASCII art.  Translator43 reduces the severity of this problem by
  63. requiring that a rubout character, 7F hex, precede in-line text commands.
  64. This change was added to make the translator useful as a reader of raw
  65. ASCII text files in addition to files creatively pre-processed for special
  66. effects.
  67.  
  68. 7.  Added Assembly Code Modules.
  69.  
  70.     Several simple repetitive routines, including the built-in unsigned
  71. byte strchr() routine, have been replaced by hand optimized assembly
  72. modules for increased processing speed.
  73.  
  74. 8.  Dropped External Language Reference Rule Capability.
  75.  
  76. This feature was dropped because the performance impact and complexity of
  77. the extra code required to make it independent of user preference
  78. selections and complications with the other modifications. Only the
  79. Italiano.accent used this function and this patch will also try to fix that
  80. reference if upgrading from version 42.4.
  81.  
  82.  
  83. Requirements.
  84.  
  85.   A complete installation of Translator42 version 42.4 or an is required.  See
  86. the section 3 of Translator.man supplied with Translator42. The Installer
  87. utility is required to run the patch script.
  88.  
  89. Status:
  90.  
  91.     Translator43 as of June 97 must be considered as in Beta Test state.
  92. It has been developed and checked out on an A4000/040 with KS3.0/WB3.1 and
  93. sporadically tested on an A1000 with KS1.2/WB1.3.  If no major problems
  94. are reported in the next 6 months, then this will stand as the finished
  95. version.
  96.  
  97. Installation:  See Update.man for more details.
  98.  
  99. 1.  (Optional Precaution) Back-up your SYS: partition, or Libs: directory.
  100.  
  101. 2.  Install Translator42.4 if this has not been done.  This step is _NOT_
  102.     required if you have already upgraded to Translator43.0.
  103.  
  104. 3.  Unpack the Tran43pch archive to a convenient directory you have
  105.     created (e.g. ram:unpack).
  106.  
  107. 4.  Stop and close out (exit/quit) all programs that might be using the
  108.     translator.library.  If possible, don't start any such programs
  109.     before the installation.
  110.  
  111. 5.  Run the Installer Script by clicking on the Install icon in the
  112.     unpacking directory.  This patches the installed sub-type  (v.33, v37,
  113.     or 020) of Translator42.4 or Translator43.0 to the equivalent
  114.     Translator43.1 sub-type and patches the v42.4 italiano.accent.
  115.  
  116. 6.  If the old translator.library was resident in ram: do to prior use, it
  117.     may be necessary to use "avail flush" or "flushlib translator.library
  118.     remove" or reboot the system before the upgrade takes effect.
  119.  
  120. 7.  (Optional) copy the Update.man file to a directory of your choice for
  121.     future reference.
  122.  
  123. 8.  (Optional) Download and Unpack the Specialized Translator43 Accent
  124.     files and copy them to Locale:accents.
  125.  
  126. Disclaimer:
  127.  
  128.     This software has not been tested in other systems or with all
  129. possible settings and combinations as commercial software is normally
  130. tested during the beta test stage.  As with most software of this type, the
  131. user must assume FULL responsibility for backing up important files etc.
  132. should this software malfunction or expose an unknown weakness in other
  133. software.  It may be wise to backup the LIBS: (sys:libs) Locale:accents
  134. directories before installing.  I have not observed any unexplained
  135. problems on my system since version 43.0 of this library was last compiled
  136. in March 97.
  137.  
  138.  
  139. Reference Files.  The following files are (or will be) Translator43 specific:
  140.  
  141. 1. Ax_1Berlin.lha (Berlin.Accent).  Experimental German accent.
  142.  
  143. 2. Ax_0Chaucer.lha (Chaucer.Accent)  Experimental Middle English accent
  144.  
  145. 3. Ax_0Paris.lha (Paris.Accent)  Stopgap Experimental French accent
  146.  
  147. 4  Ax_2USA.lha (!USA.Accent)    Huge (150K) USA accent. May be slow on
  148.    68000 based systems.
  149.  
  150. 5. SWread.lha   Simplified version of Wreadfiles 5.1 (no internal USA
  151.    English translation enhancement) vocal text reader; !USA.accent
  152.    required for Wreadfiles equivalent USA English functionality.
  153.    See AMINET/utils/misc for SWread.lha, SWread_020.lha, or
  154.    SWread_040.lha.  Amiga native HIRES display capability is required.
  155.  
  156.  
  157. ============================= Archive contents =============================
  158.  
  159. Original  Packed Ratio    Date     Time    Name
  160. -------- ------- ----- --------- --------  -------------
  161.     6660    4695 29.5% 30-Jun-97 05:51:10 +020_translator.pch
  162.      736     615 16.4% 30-Jun-97 05:51:44 +020_translator1.pch
  163.     6557    1388 78.8% 03-Jul-97 00:50:28 +install
  164.     1226     491 59.9% 20-May-97 18:46:26 +Install.info
  165.      224     197 12.0% 10-Mar-97 05:15:58 +italiano.pch
  166.    14636    9285 36.5% 16-May-94 21:19:26 +spatch
  167.     6664    3039 54.3% 03-Jul-97 07:45:00 +Tran43pch.readme
  168.      380     171 55.0% 20-May-97 18:46:26 +Tran43pch.readme.info
  169.    27336   10576 61.3% 03-Jul-97 07:09:08 +update.man
  170.      380     164 56.8% 20-May-97 18:46:26 +update.man.info
  171.     6212    4431 28.6% 30-Jun-97 05:50:36 +v33_translator.pch
  172.      688     582 15.4% 30-Jun-97 05:51:32 +v33_translator1.pch
  173.     6648    4664 29.8% 30-Jun-97 05:50:00 +v37_translator.pch
  174.      728     612 15.9% 30-Jun-97 05:51:20 +v37_translator1.pch
  175.      632     276 56.3% 08-Jun-97 20:52:40  _Patch43.info
  176. -------- ------- ----- --------- --------
  177.    79707   41186 48.3% 04-Jul-97 08:08:00   15 files
  178.